<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>gimpdrawable: GIMP 3 Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GIMP 3 Library Reference Manual">
<link rel="up" href="libgimp-image.html" title="Manipulating Images and their Properties">
<link rel="prev" href="GimpDisplay.html" title="gimpdisplay">
<link rel="next" href="libgimp3-gimpdrawablecolor.html" title="gimpdrawablecolor">
<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GimpDrawable.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GimpDrawable.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="libgimp-image.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GimpDisplay.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="libgimp3-gimpdrawablecolor.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GimpDrawable"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GimpDrawable.top_of_page"></a>gimpdrawable</span></h2>
<p>gimpdrawable — Functions to manipulate drawables.</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GimpDrawable.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="returnvalue">GimpDrawable</span></a> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-by-id" title="gimp_drawable_get_by_id ()">gimp_drawable_get_by_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GeglBuffer</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-buffer" title="gimp_drawable_get_buffer ()">gimp_drawable_get_buffer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GeglBuffer</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-shadow-buffer" title="gimp_drawable_get_shadow_buffer ()">gimp_drawable_get_shadow_buffer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">Babl</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-format" title="gimp_drawable_get_format ()">gimp_drawable_get_format</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">Babl</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-thumbnail-format" title="gimp_drawable_get_thumbnail_format ()">gimp_drawable_get_thumbnail_format</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guchar</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-thumbnail-data" title="gimp_drawable_get_thumbnail_data ()">gimp_drawable_get_thumbnail_data</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkPixbuf</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-thumbnail" title="gimp_drawable_get_thumbnail ()">gimp_drawable_get_thumbnail</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guint8</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-pixel" title="gimp_drawable_get_pixel ()">gimp_drawable_get_pixel</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-set-pixel" title="gimp_drawable_set_pixel ()">gimp_drawable_set_pixel</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guchar</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-sub-thumbnail-data" title="gimp_drawable_get_sub_thumbnail_data ()">gimp_drawable_get_sub_thumbnail_data</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkPixbuf</span> *
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-get-sub-thumbnail" title="gimp_drawable_get_sub_thumbnail ()">gimp_drawable_get_sub_thumbnail</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-merge-shadow" title="gimp_drawable_merge_shadow ()">gimp_drawable_merge_shadow</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-free-shadow" title="gimp_drawable_free_shadow ()">gimp_drawable_free_shadow</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-fill" title="gimp_drawable_fill ()">gimp_drawable_fill</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-update" title="gimp_drawable_update ()">gimp_drawable_update</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-mask-bounds" title="gimp_drawable_mask_bounds ()">gimp_drawable_mask_bounds</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-mask-intersect" title="gimp_drawable_mask_intersect ()">gimp_drawable_mask_intersect</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-has-alpha" title="gimp_drawable_has_alpha ()">gimp_drawable_has_alpha</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../html/libgimpbase3-gimpbaseenums.html#GimpImageType"><span class="returnvalue">GimpImageType</span></a>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-type-with-alpha" title="gimp_drawable_type_with_alpha ()">gimp_drawable_type_with_alpha</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../html/libgimpbase3-gimpbaseenums.html#GimpImageType"><span class="returnvalue">GimpImageType</span></a>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-type" title="gimp_drawable_type ()">gimp_drawable_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-is-rgb" title="gimp_drawable_is_rgb ()">gimp_drawable_is_rgb</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-is-gray" title="gimp_drawable_is_gray ()">gimp_drawable_is_gray</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-is-indexed" title="gimp_drawable_is_indexed ()">gimp_drawable_is_indexed</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-bpp" title="gimp_drawable_bpp ()">gimp_drawable_bpp</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-width" title="gimp_drawable_width ()">gimp_drawable_width</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-height" title="gimp_drawable_height ()">gimp_drawable_height</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-offsets" title="gimp_drawable_offsets ()">gimp_drawable_offsets</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-offset" title="gimp_drawable_offset ()">gimp_drawable_offset</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GimpDrawable.html#gimp-drawable-foreground-extract" title="gimp_drawable_foreground_extract ()">gimp_drawable_foreground_extract</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GimpDrawable.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    GObject
    <span class="lineart">╰──</span> <a class="link" href="GimpItem.html" title="gimpitem">GimpItem</a>
        <span class="lineart">╰──</span> GimpDrawable
            <span class="lineart">├──</span> <a class="link" href="GimpChannel.html" title="gimpchannel">GimpChannel</a>
            <span class="lineart">╰──</span> <a class="link" href="GimpLayer.html" title="gimplayer">GimpLayer</a>
</pre>
</div>
<div class="refsect1">
<a name="GimpDrawable.description"></a><h2>Description</h2>
<p>Functions to manipulate drawables.</p>
</div>
<div class="refsect1">
<a name="GimpDrawable.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gimp-drawable-get-by-id"></a><h3>gimp_drawable_get_by_id ()</h3>
<pre class="programlisting"><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="returnvalue">GimpDrawable</span></a> *
gimp_drawable_get_by_id (<em class="parameter"><code><span class="type">gint32</span> drawable_id</code></em>);</pre>
<p>Returns a <a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> representing <em class="parameter"><code>drawable_id</code></em>
. This function
calls <a class="link" href="GimpItem.html#gimp-item-get-by-id" title="gimp_item_get_by_id ()"><code class="function">gimp_item_get_by_id()</code></a> and returns the item if it is drawable
or <code class="literal">NULL</code> otherwise.</p>
<div class="refsect3">
<a name="gimp-drawable-get-by-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable_id</p></td>
<td class="parameter_description"><p>The drawable id.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-by-id.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> for
<em class="parameter"><code>drawable_id</code></em>
or <code class="literal">NULL</code> if <em class="parameter"><code>drawable_id</code></em>
does not represent a
valid drawable. The object belongs to libgimp and you must
not modify or unref it. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-buffer"></a><h3>gimp_drawable_get_buffer ()</h3>
<pre class="programlisting"><span class="returnvalue">GeglBuffer</span> *
gimp_drawable_get_buffer (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns a <span class="type">GeglBuffer</span> of a specified drawable. The buffer can be used
like any other GEGL buffer. Its data will we synced back with the core
drawable when the buffer gets destroyed, or when <code class="function">gegl_buffer_flush()</code>
is called.</p>
<div class="refsect3">
<a name="gimp-drawable-get-buffer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>the ID of the <a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> to get the buffer for.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-buffer.returns"></a><h4>Returns</h4>
<p>The <span class="type">GeglBuffer</span>.</p>
<p>See Also: <a class="link" href="GimpDrawable.html#gimp-drawable-get-shadow-buffer" title="gimp_drawable_get_shadow_buffer ()"><code class="function">gimp_drawable_get_shadow_buffer()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-shadow-buffer"></a><h3>gimp_drawable_get_shadow_buffer ()</h3>
<pre class="programlisting"><span class="returnvalue">GeglBuffer</span> *
gimp_drawable_get_shadow_buffer (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns a <span class="type">GeglBuffer</span> of a specified drawable's shadow tiles. The
buffer can be used like any other GEGL buffer. Its data will we
synced back with the core drawable's shadow tiles when the buffer
gets destroyed, or when <code class="function">gegl_buffer_flush()</code> is called.</p>
<div class="refsect3">
<a name="gimp-drawable-get-shadow-buffer.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>the ID of the <a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> to get the buffer for.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-shadow-buffer.returns"></a><h4>Returns</h4>
<p>The <span class="type">GeglBuffer</span>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-format"></a><h3>gimp_drawable_get_format ()</h3>
<pre class="programlisting">const <span class="returnvalue">Babl</span> *
gimp_drawable_get_format (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns the <span class="type">Babl</span> format of the drawable.</p>
<div class="refsect3">
<a name="gimp-drawable-get-format.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>the ID of the <a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> to get the format for.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-format.returns"></a><h4>Returns</h4>
<p> The <span class="type">Babl</span> format.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10.html#api-index-2.10">2.10</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-thumbnail-format"></a><h3>gimp_drawable_get_thumbnail_format ()</h3>
<pre class="programlisting">const <span class="returnvalue">Babl</span> *
gimp_drawable_get_thumbnail_format (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns the <span class="type">Babl</span> thumbnail format of the drawable.</p>
<div class="refsect3">
<a name="gimp-drawable-get-thumbnail-format.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>the ID of the <a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> to get the thumbnail format for.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-thumbnail-format.returns"></a><h4>Returns</h4>
<p> The <span class="type">Babl</span> thumbnail format.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-10-14.html#api-index-2.10.14">2.10.14</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-thumbnail-data"></a><h3>gimp_drawable_get_thumbnail_data ()</h3>
<pre class="programlisting"><span class="returnvalue">guchar</span> *
gimp_drawable_get_thumbnail_data (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                                  <em class="parameter"><code><span class="type">gint</span> *width</code></em>,
                                  <em class="parameter"><code><span class="type">gint</span> *height</code></em>,
                                  <em class="parameter"><code><span class="type">gint</span> *bpp</code></em>);</pre>
<p>Retrieves thumbnail data for the drawable identified by <em class="parameter"><code>drawable</code></em>
.
The thumbnail will be not larger than the requested size.</p>
<div class="refsect3">
<a name="gimp-drawable-get-thumbnail-data.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>the drawable</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>the requested thumbnail width  (&lt;= 1024 pixels). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>the requested thumbnail height (&lt;= 1024 pixels). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>bpp</p></td>
<td class="parameter_description"><p>the bytes per pixel of the returned thubmnail data. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-thumbnail-data.returns"></a><h4>Returns</h4>
<p>thumbnail data or <code class="literal">NULL</code> if
<em class="parameter"><code>drawable</code></em>
is invalid. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-thumbnail"></a><h3>gimp_drawable_get_thumbnail ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *
gimp_drawable_get_thumbnail (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                             <em class="parameter"><code><span class="type">gint</span> width</code></em>,
                             <em class="parameter"><code><span class="type">gint</span> height</code></em>,
                             <em class="parameter"><code><a class="link" href="libgimp3-Gimp.html#GimpPixbufTransparency" title="enum GimpPixbufTransparency"><span class="type">GimpPixbufTransparency</span></a> alpha</code></em>);</pre>
<p>Retrieves a thumbnail pixbuf for the drawable identified by
<em class="parameter"><code>drawable</code></em>
. The thumbnail will be not larger than the requested
size.</p>
<div class="refsect3">
<a name="gimp-drawable-get-thumbnail.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>the drawable</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>the requested thumbnail width  (&lt;= 1024 pixels)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>the requested thumbnail height (&lt;= 1024 pixels)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>alpha</p></td>
<td class="parameter_description"><p>how to handle an alpha channel</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-thumbnail.returns"></a><h4>Returns</h4>
<p>a new <span class="type">GdkPixbuf</span>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-2.html#api-index-2.2">2.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-pixel"></a><h3>gimp_drawable_get_pixel ()</h3>
<pre class="programlisting"><span class="returnvalue">guint8</span> *
gimp_drawable_get_pixel (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                         <em class="parameter"><code><span class="type">gint</span> x_coord</code></em>,
                         <em class="parameter"><code><span class="type">gint</span> y_coord</code></em>,
                         <em class="parameter"><code><span class="type">gint</span> *num_channels</code></em>);</pre>
<p>Gets the value of the pixel at the specified coordinates.</p>
<p>This procedure gets the pixel value at the specified coordinates.
The 'num_channels' argument must always be equal to the
bytes-per-pixel value for the specified drawable.</p>
<div class="refsect3">
<a name="gimp-drawable-get-pixel.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x_coord</p></td>
<td class="parameter_description"><p>The x coordinate.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y_coord</p></td>
<td class="parameter_description"><p>The y coordinate.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>num_channels</p></td>
<td class="parameter_description"><p>The number of channels for the pixel. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-pixel.returns"></a><h4>Returns</h4>
<p>The pixel value.
The returned value must be freed with <code class="function">g_free()</code>. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_channels][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-set-pixel"></a><h3>gimp_drawable_set_pixel ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_set_pixel (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                         <em class="parameter"><code><span class="type">gint</span> x_coord</code></em>,
                         <em class="parameter"><code><span class="type">gint</span> y_coord</code></em>,
                         <em class="parameter"><code><span class="type">gint</span> num_channels</code></em>,
                         <em class="parameter"><code>const <span class="type">guint8</span> *pixel</code></em>);</pre>
<p>Sets the value of the pixel at the specified coordinates.</p>
<p>This procedure sets the pixel value at the specified coordinates.
The 'num_channels' argument must always be equal to the
bytes-per-pixel value for the specified drawable. Note that this
function is not undoable, you should use it only on drawables you
just created yourself.</p>
<div class="refsect3">
<a name="gimp-drawable-set-pixel.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x_coord</p></td>
<td class="parameter_description"><p>The x coordinate.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y_coord</p></td>
<td class="parameter_description"><p>The y coordinate.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>num_channels</p></td>
<td class="parameter_description"><p>The number of channels for the pixel.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>pixel</p></td>
<td class="parameter_description"><p>The pixel value. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_channels][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> guint8]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-set-pixel.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-sub-thumbnail-data"></a><h3>gimp_drawable_get_sub_thumbnail_data ()</h3>
<pre class="programlisting"><span class="returnvalue">guchar</span> *
gimp_drawable_get_sub_thumbnail_data (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> src_x</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> src_y</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> src_width</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> src_height</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> *dest_width</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> *dest_height</code></em>,
                                      <em class="parameter"><code><span class="type">gint</span> *bpp</code></em>);</pre>
<p>Retrieves thumbnail data for the drawable identified by <em class="parameter"><code>drawable</code></em>
.
The thumbnail will be not larger than the requested size.</p>
<div class="refsect3">
<a name="gimp-drawable-get-sub-thumbnail-data.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>the drawable ID</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src_x</p></td>
<td class="parameter_description"><p>the x coordinate of the area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src_y</p></td>
<td class="parameter_description"><p>the y coordinate of the area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src_width</p></td>
<td class="parameter_description"><p>the width of the area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src_height</p></td>
<td class="parameter_description"><p>the height of the area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dest_width</p></td>
<td class="parameter_description"><p>the requested thumbnail width  (&lt;= 1024 pixels). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>dest_height</p></td>
<td class="parameter_description"><p>the requested thumbnail height (&lt;= 1024 pixels). </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>bpp</p></td>
<td class="parameter_description"><p>the bytes per pixel of the returned thumbnail data. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-sub-thumbnail-data.returns"></a><h4>Returns</h4>
<p>thumbnail data or <code class="literal">NULL</code> if
<em class="parameter"><code>drawable</code></em>
is invalid. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-get-sub-thumbnail"></a><h3>gimp_drawable_get_sub_thumbnail ()</h3>
<pre class="programlisting"><span class="returnvalue">GdkPixbuf</span> *
gimp_drawable_get_sub_thumbnail (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                                 <em class="parameter"><code><span class="type">gint</span> src_x</code></em>,
                                 <em class="parameter"><code><span class="type">gint</span> src_y</code></em>,
                                 <em class="parameter"><code><span class="type">gint</span> src_width</code></em>,
                                 <em class="parameter"><code><span class="type">gint</span> src_height</code></em>,
                                 <em class="parameter"><code><span class="type">gint</span> dest_width</code></em>,
                                 <em class="parameter"><code><span class="type">gint</span> dest_height</code></em>,
                                 <em class="parameter"><code><a class="link" href="libgimp3-Gimp.html#GimpPixbufTransparency" title="enum GimpPixbufTransparency"><span class="type">GimpPixbufTransparency</span></a> alpha</code></em>);</pre>
<p>Retrieves a thumbnail pixbuf for the drawable identified by
<em class="parameter"><code>drawable</code></em>
. The thumbnail will be not larger than the requested
size.</p>
<div class="refsect3">
<a name="gimp-drawable-get-sub-thumbnail.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>the drawable ID</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src_x</p></td>
<td class="parameter_description"><p>the x coordinate of the area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src_y</p></td>
<td class="parameter_description"><p>the y coordinate of the area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src_width</p></td>
<td class="parameter_description"><p>the width of the area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src_height</p></td>
<td class="parameter_description"><p>the height of the area</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dest_width</p></td>
<td class="parameter_description"><p>the requested thumbnail width  (&lt;= 1024 pixels)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>dest_height</p></td>
<td class="parameter_description"><p>the requested thumbnail height (&lt;= 1024 pixels)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>alpha</p></td>
<td class="parameter_description"><p>how to handle an alpha channel</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-get-sub-thumbnail.returns"></a><h4>Returns</h4>
<p>a new <span class="type">GdkPixbuf</span>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-2.html#api-index-2.2">2.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-merge-shadow"></a><h3>gimp_drawable_merge_shadow ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_merge_shadow (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                            <em class="parameter"><code><span class="type">gboolean</span> undo</code></em>);</pre>
<p>Merge the shadow buffer with the specified drawable.</p>
<p>This procedure combines the contents of the drawable's shadow buffer
(for temporary processing) with the specified drawable. The 'undo'
parameter specifies whether to add an undo step for the operation.
Requesting no undo is useful for such applications as 'auto-apply'.</p>
<div class="refsect3">
<a name="gimp-drawable-merge-shadow.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>undo</p></td>
<td class="parameter_description"><p>Push merge to undo stack?</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-merge-shadow.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-free-shadow"></a><h3>gimp_drawable_free_shadow ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_free_shadow (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Free the specified drawable's shadow data (if it exists).</p>
<p>This procedure is intended as a memory saving device. If any shadow
memory has been allocated, it will be freed automatically when the
drawable is removed from the image, or when the plug-in procedure
which allocated it returns.</p>
<div class="refsect3">
<a name="gimp-drawable-free-shadow.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-free-shadow.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-fill"></a><h3>gimp_drawable_fill ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_fill (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                    <em class="parameter"><code><a href="../html/libgimpbase3-gimpbaseenums.html#GimpFillType"><span class="type">GimpFillType</span></a> fill_type</code></em>);</pre>
<p>Fill the drawable with the specified fill mode.</p>
<p>This procedure fills the drawable. If the fill mode is foreground
the current foreground color is used. If the fill mode is
background, the current background color is used. If the fill type
is white, then white is used. Transparent fill only affects layers
with an alpha channel, in which case the alpha channel is set to
transparent. If the drawable has no alpha channel, it is filled to
white. No fill leaves the drawable's contents undefined.
This procedure is unlike <a href="/local/head/share/gtk-doc/html/libgimp/libgimp-gimpedit.html#gimp-edit-fill"><code class="function">gimp_edit_fill()</code></a> or the bucket fill tool
because it fills regardless of a selection. Its main purpose is to
fill a newly created drawable before adding it to the image. This
operation cannot be undone.</p>
<div class="refsect3">
<a name="gimp-drawable-fill.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>fill_type</p></td>
<td class="parameter_description"><p>The type of fill.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-fill.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-update"></a><h3>gimp_drawable_update ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_update (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                      <em class="parameter"><code><span class="type">gint</span> x</code></em>,
                      <em class="parameter"><code><span class="type">gint</span> y</code></em>,
                      <em class="parameter"><code><span class="type">gint</span> width</code></em>,
                      <em class="parameter"><code><span class="type">gint</span> height</code></em>);</pre>
<p>Update the specified region of the drawable.</p>
<p>This procedure updates the specified region of the drawable. The (x,
y) coordinate pair is relative to the drawable's origin, not to the
image origin. Therefore, the entire drawable can be updated using
(0, 0, width, height).</p>
<div class="refsect3">
<a name="gimp-drawable-update.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>x coordinate of upper left corner of update region.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>y coordinate of upper left corner of update region.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>Width of update region.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>Height of update region.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-update.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-mask-bounds"></a><h3>gimp_drawable_mask_bounds ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_mask_bounds (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> *x1</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> *y1</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> *x2</code></em>,
                           <em class="parameter"><code><span class="type">gint</span> *y2</code></em>);</pre>
<p>Find the bounding box of the current selection in relation to the
specified drawable.</p>
<p>This procedure returns whether there is a selection. If there is
one, the upper left and lower right-hand corners of its bounding box
are returned. These coordinates are specified relative to the
drawable's origin, and bounded by the drawable's extents. Please
note that the pixel specified by the lower right-hand coordinate of
the bounding box is not part of the selection. The selection ends at
the upper left corner of this pixel. This means the width of the
selection can be calculated as (x2 - x1), its height as (y2 - y1).
Note that the returned boolean does NOT correspond with the returned
region being empty or not, it always returns whether the selection
is non_empty. See <a class="link" href="GimpDrawable.html#gimp-drawable-mask-intersect" title="gimp_drawable_mask_intersect ()"><code class="function">gimp_drawable_mask_intersect()</code></a> for a boolean
return value which is more useful in most cases.</p>
<div class="refsect3">
<a name="gimp-drawable-mask-bounds.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x1</p></td>
<td class="parameter_description"><p>x coordinate of the upper left corner of selection bounds. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>y1</p></td>
<td class="parameter_description"><p>y coordinate of the upper left corner of selection bounds. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>x2</p></td>
<td class="parameter_description"><p>x coordinate of the lower right corner of selection bounds. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>y2</p></td>
<td class="parameter_description"><p>y coordinate of the lower right corner of selection bounds. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-mask-bounds.returns"></a><h4>Returns</h4>
<p> TRUE if there is a selection.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-mask-intersect"></a><h3>gimp_drawable_mask_intersect ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_mask_intersect (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> *x</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> *y</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> *width</code></em>,
                              <em class="parameter"><code><span class="type">gint</span> *height</code></em>);</pre>
<p>Find the bounding box of the current selection in relation to the
specified drawable.</p>
<p>This procedure returns whether there is an intersection between the
drawable and the selection. Unlike <a class="link" href="GimpDrawable.html#gimp-drawable-mask-bounds" title="gimp_drawable_mask_bounds ()"><code class="function">gimp_drawable_mask_bounds()</code></a>, the
intersection's bounds are returned as x, y, width, height.
If there is no selection this function returns TRUE and the returned
bounds are the extents of the whole drawable.</p>
<div class="refsect3">
<a name="gimp-drawable-mask-intersect.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>x</p></td>
<td class="parameter_description"><p>x coordinate of the upper left corner of the intersection. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>y</p></td>
<td class="parameter_description"><p>y coordinate of the upper left corner of the intersection. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>width</p></td>
<td class="parameter_description"><p>width of the intersection. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>height</p></td>
<td class="parameter_description"><p>height of the intersection. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-mask-intersect.returns"></a><h4>Returns</h4>
<p> TRUE if the returned area is not empty.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-2.html#api-index-2.2">2.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-has-alpha"></a><h3>gimp_drawable_has_alpha ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_has_alpha (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns TRUE if the drawable has an alpha channel.</p>
<p>This procedure returns whether the specified drawable has an alpha
channel. This can only be true for layers, and the associated type
will be one of: { RGBA , GRAYA, INDEXEDA }.</p>
<div class="refsect3">
<a name="gimp-drawable-has-alpha.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-has-alpha.returns"></a><h4>Returns</h4>
<p> Does the drawable have an alpha channel?</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-type-with-alpha"></a><h3>gimp_drawable_type_with_alpha ()</h3>
<pre class="programlisting"><a href="../html/libgimpbase3-gimpbaseenums.html#GimpImageType"><span class="returnvalue">GimpImageType</span></a>
gimp_drawable_type_with_alpha (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns the drawable's type with alpha.</p>
<p>This procedure returns the drawable's type as if had an alpha
channel. If the type is currently Gray, for instance, the returned
type would be GrayA. If the drawable already has an alpha channel,
the drawable's type is simply returned.</p>
<div class="refsect3">
<a name="gimp-drawable-type-with-alpha.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-type-with-alpha.returns"></a><h4>Returns</h4>
<p> The drawable's type with alpha.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-type"></a><h3>gimp_drawable_type ()</h3>
<pre class="programlisting"><a href="../html/libgimpbase3-gimpbaseenums.html#GimpImageType"><span class="returnvalue">GimpImageType</span></a>
gimp_drawable_type (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns the drawable's type.</p>
<p>This procedure returns the drawable's type.</p>
<div class="refsect3">
<a name="gimp-drawable-type.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-type.returns"></a><h4>Returns</h4>
<p> The drawable's type.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-is-rgb"></a><h3>gimp_drawable_is_rgb ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_is_rgb (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns whether the drawable is an RGB type.</p>
<p>This procedure returns TRUE if the specified drawable is of type {
RGB, RGBA }.</p>
<div class="refsect3">
<a name="gimp-drawable-is-rgb.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-is-rgb.returns"></a><h4>Returns</h4>
<p> TRUE if the drawable is an RGB type.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-is-gray"></a><h3>gimp_drawable_is_gray ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_is_gray (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns whether the drawable is a grayscale type.</p>
<p>This procedure returns TRUE if the specified drawable is of type {
Gray, GrayA }.</p>
<div class="refsect3">
<a name="gimp-drawable-is-gray.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-is-gray.returns"></a><h4>Returns</h4>
<p> TRUE if the drawable is a grayscale type.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-is-indexed"></a><h3>gimp_drawable_is_indexed ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_is_indexed (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns whether the drawable is an indexed type.</p>
<p>This procedure returns TRUE if the specified drawable is of type {
Indexed, IndexedA }.</p>
<div class="refsect3">
<a name="gimp-drawable-is-indexed.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-is-indexed.returns"></a><h4>Returns</h4>
<p> TRUE if the drawable is an indexed type.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-bpp"></a><h3>gimp_drawable_bpp ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gimp_drawable_bpp (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns the bytes per pixel.</p>
<p>This procedure returns the number of bytes per pixel.</p>
<div class="refsect3">
<a name="gimp-drawable-bpp.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-bpp.returns"></a><h4>Returns</h4>
<p> Bytes per pixel.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-width"></a><h3>gimp_drawable_width ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gimp_drawable_width (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns the width of the drawable.</p>
<p>This procedure returns the specified drawable's width in pixels.</p>
<div class="refsect3">
<a name="gimp-drawable-width.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-width.returns"></a><h4>Returns</h4>
<p> Width of drawable.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-height"></a><h3>gimp_drawable_height ()</h3>
<pre class="programlisting"><span class="returnvalue">gint</span>
gimp_drawable_height (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>);</pre>
<p>Returns the height of the drawable.</p>
<p>This procedure returns the specified drawable's height in pixels.</p>
<div class="refsect3">
<a name="gimp-drawable-height.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-height.returns"></a><h4>Returns</h4>
<p> Height of drawable.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-offsets"></a><h3>gimp_drawable_offsets ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_offsets (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                       <em class="parameter"><code><span class="type">gint</span> *offset_x</code></em>,
                       <em class="parameter"><code><span class="type">gint</span> *offset_y</code></em>);</pre>
<p>Returns the offsets for the drawable.</p>
<p>This procedure returns the specified drawable's offsets. This only
makes sense if the drawable is a layer since channels are anchored.
The offsets of a channel will be returned as 0.</p>
<div class="refsect3">
<a name="gimp-drawable-offsets.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>offset_x</p></td>
<td class="parameter_description"><p>x offset of drawable. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>offset_y</p></td>
<td class="parameter_description"><p>y offset of drawable. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-offsets.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-offset"></a><h3>gimp_drawable_offset ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_offset (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                      <em class="parameter"><code><span class="type">gboolean</span> wrap_around</code></em>,
                      <em class="parameter"><code><a href="../html/libgimpbase3-gimpbaseenums.html#GimpOffsetType"><span class="type">GimpOffsetType</span></a> fill_type</code></em>,
                      <em class="parameter"><code><span class="type">gint</span> offset_x</code></em>,
                      <em class="parameter"><code><span class="type">gint</span> offset_y</code></em>);</pre>
<p>Offset the drawable by the specified amounts in the X and Y
directions</p>
<p>This procedure offsets the specified drawable by the amounts
specified by 'offset_x' and 'offset_y'. If 'wrap_around' is set to
TRUE, then portions of the drawable which are offset out of bounds
are wrapped around. Alternatively, the undefined regions of the
drawable can be filled with transparency or the background color, as
specified by the 'fill-type' parameter.</p>
<div class="refsect3">
<a name="gimp-drawable-offset.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable to offset.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>wrap_around</p></td>
<td class="parameter_description"><p>wrap image around or fill vacated regions.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>fill_type</p></td>
<td class="parameter_description"><p>fill vacated regions of drawable with background or transparent.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>offset_x</p></td>
<td class="parameter_description"><p>offset by this amount in X direction.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>offset_y</p></td>
<td class="parameter_description"><p>offset by this amount in Y direction.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-offset.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gimp-drawable-foreground-extract"></a><h3>gimp_drawable_foreground_extract ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gimp_drawable_foreground_extract (<em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *drawable</code></em>,
                                  <em class="parameter"><code><a href="../html/libgimpbase3-gimpbaseenums.html#GimpForegroundExtractMode"><span class="type">GimpForegroundExtractMode</span></a> mode</code></em>,
                                  <em class="parameter"><code><a class="link" href="GimpDrawable.html" title="gimpdrawable"><span class="type">GimpDrawable</span></a> *mask</code></em>);</pre>
<p>Extract the foreground of a drawable using a given trimap.</p>
<p>Image Segmentation by Uniform Color Clustering, see
https://www.inf.fu-berlin.de/inst/pubs/tr-b-05-07.pdf</p>
<div class="refsect3">
<a name="gimp-drawable-foreground-extract.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>drawable</p></td>
<td class="parameter_description"><p>The drawable.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>The algorithm to use.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mask</p></td>
<td class="parameter_description"><p>Tri-Map.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gimp-drawable-foreground-extract.returns"></a><h4>Returns</h4>
<p> TRUE on success.</p>
</div>
<p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.0</div>
</body>
</html>